home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / tfe_100.arc / TFE.DOC < prev    next >
Text File  |  1989-07-07  |  19KB  |  428 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      TelixFonEd (TFE) v1.0                                          page  1
  8.  
  9.  
  10.      TelixFonEd v1.0 - Copyright (c) 1988 by Paul Roub
  11.      A full-screen editor for Telix version 3 FON files.
  12.  
  13.  
  14.      TelixFonEd (TFE) is designed to give you fuller and easier control over
  15.      the content and arrangement of  your  Telix  version  3.0  (or greater)
  16.      dialing directories (FON files).
  17.  
  18.      Using TFE, you can:
  19.  
  20.           o    Sort a dialing directory by name, ignoring leading blanks and
  21.                the's.
  22.           o    Insert and delete entries at random.
  23.           o    Copy a range of entries within a directory.
  24.           o    Move a group of entries from one location  in a  directory to
  25.                another.
  26.           o    Write part of a directory (or an entire directory) to a given
  27.                FON file.
  28.           o    Import (merge) another FON file into the file currently being
  29.                edited.
  30.           o    Print selected entries or all entries to a file or printer.
  31.           o    Edit all fields of all entries in a full-screen visual format
  32.                (no more <ENTER>ing through every field  in an  entry just to
  33.                change the password).
  34.           o    Bring up pull-down menus for all fields with a known range of
  35.                options (Protocols,  Terminal  types,  etc.),  on  request or
  36.                whenever an invalid entry is made.
  37.  
  38.  
  39.      This documentation  should tell  you all  you need  to know about using
  40.      TFE.  Further questions should be directed to  the author,  through the
  41.      following means:
  42.  
  43.           Messages in the FidoNet Telix echo, addressed to Paul Roub
  44.           Fido NetMail to Paul Roub at 1:135/47
  45.           or US Mail to:
  46.                Paul Roub
  47.                690 Anderson Court
  48.                Satellite Beach, FL
  49.                              32937
  50.  
  51.      When making  bug reports,  please be  specific as to their nature (i.e.
  52.      when did it happen, what error message (if any) ensued,  can you repeat
  53.      it, etc.).
  54.  
  55.      TFE  may  be  distributed  freely  (in fact, I would appreciate it very
  56.      much), provided that the full, unmodified archive is distributed.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      TelixFonEd (TFE) v1.0                                          page  2
  64.  
  65.  
  66.      If you find TFE useful, please  fill out  and send  in the registration
  67.      form  at  the  end  of  this document.  You'll be supporting shareware,
  68.      making possible future improved  versions of  this and  other programs,
  69.      and you'll  also get  the latest  version on disk, optionally with full
  70.      source code!  Note that TFE may NOT be used in a business or commercial
  71.      environment without registration.
  72.  
  73.      Note to users of DoubleDos, DesqView and other multitaskers: do NOT use
  74.      TFE when Telix itself is running in another window.   Havoc will ensue,
  75.      TRUST ME.  In general, you're asking for trouble if you modify ANY file
  76.      in use by a concurrent process.
  77.  
  78.      The author makes no claims as  to the  suitability of  this product for
  79.      any applications.   In the event of malfunction, the author's liability
  80.      shall be limited to a replacement or refund.
  81.  
  82.      TFE is written in Microsoft C v5.1 and  Microsoft MASM  v5.0, using the
  83.      ProMake program maintenance utility.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.      TelixFonEd (TFE) v1.0                                          page  3
  91.  
  92.  
  93.                             Startup and Configuration
  94.  
  95.  
  96.      Telix users  will feel right at home with TFE.  It reads your TELIX.CNF
  97.      configuration file to determine  which screen  colors and  screen write
  98.      mode to  use, what  external protocols  are available, and your default
  99.      settings (to use when adding  new  entries).    The  TFE  screen should
  100.      therefore look  pretty much  like your  Telix dialing  directory.  Note
  101.      that if TELIX.CNF is  not in  the current  directory, TFE  will use the
  102.      following defaults:
  103.  
  104.           Black-and-white colors
  105.           BIOS used for screen access
  106.           Modem parameters 1200 NE1
  107.           No external protocols
  108.  
  109.  
  110.      The command line syntax is simple:
  111.  
  112.           TFE [filename][.ext]
  113.  
  114.      If no  filename is  given, TFE will assume TELIX.FON.  If a filename is
  115.      given with no extension,  TFE will  append the  extension .FON.   If no
  116.      extension is desired, use a trailing '.' at the end of the filename.
  117.  
  118.      If TFE  can't find  the FON  file in  question, it will pop up a window
  119.      asking you to name the file you wish to edit.   At  this point  you can
  120.      enter a filename, or hit your ESC key to end the program.  This process
  121.      will repeat until a valid filename (or ESC) is entered.
  122.  
  123.      At this point, you will see  the  TFE  screen,  which  contains several
  124.      sections.  The top line contains copyright information.  Next is a two-
  125.      part box;  the first line contains the names of the current (on screen)
  126.      fields.   The rest  contains the fields themselves, for as many entries
  127.      as will fit on screen (note that a 'field' is, for instance, a BBS name
  128.      or  phone  number,  whereas  an  'entry' is all the information for one
  129.      particular service, such as  the name,  number, etc.  for a  BBS).  The
  130.      next line  down contains  a more  detailed description of the currently
  131.      edited field (the field containing the  highlight bar  -- more  on that
  132.      later).   The last  line shows  a list  of possible  Alt-keys, also ex-
  133.      plained later.
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      TelixFonEd (TFE) v1.0                                          page  4
  140.  
  141.  
  142.                           Movement and Editing Commands
  143.  
  144.  
  145.      Using the various movement keys, you can move  through the  fields in a
  146.      manner very similar to a spreadsheet or word processor.  If you move up
  147.      or down past the  end of  the currently  displayed entries,  the screen
  148.      will scroll  up or  down as necessary.  Similarly, moving right or left
  149.      past the screen will let you edit fields  beyond those  currently shown
  150.      on screen.   At  any time  you can  edit the  data in the current field
  151.      using the editing keys.  Play with the movement and editing keys  a bit
  152.      and you should get a feel for the functions quickly.
  153.  
  154.  
  155.      The following movement and editing keys are used:
  156.      (notations such  as Shift-Tab mean, for example, to hold down the Shift
  157.      key and press Tab)
  158.  
  159.      Left:          Move left one character in the current field.  If at the
  160.                     beginning of the field, move to the previous field.
  161.      Right:         Move right  one character  in the  current field.  If at
  162.                     the end of the field, move to the next field.
  163.      Tab:           Move to the next field.
  164.      Shift-Tab:     Move to the previous field
  165.      Home:          Move to the top (first) entry
  166.      End:           Move to the bottom (last) entry
  167.      Control-Left:  Move to the first field of the current entry.
  168.      Control-Right: Move to the last field of the current entry.
  169.      PgUp:          Move one page down the entry list.
  170.      PgDn:          Move one page up the entry list.
  171.      Del:           Delete the current character in the current field.
  172.      Ins:           Toggle insert mode.  When insert mode is  TRUE, entering
  173.                     a character  pushes all following characters in the same
  174.                     field to the right.  Insert mode is  reset to  TRUE upon
  175.                     entering any field.
  176.      Backspace:     Delete the previous character in the current field.
  177.      F1:            Pop-up a  menu of allowable values for this field.  Pick
  178.                     one by  pointing to  it and  hitting <enter>,  or ESC to
  179.                     pick none.
  180.      ESC:           Undo any editing done to the current field.
  181.      ENTER:         Accept the current edited value for the current field.
  182.  
  183.  
  184.      When you leave a field (by hitting <enter>, selecting a menu option, or
  185.      moving to  another  field  or  entry),  it  is  validated  if possible.
  186.      Although a  few fields have no restrictions as to what they may contain
  187.      (e.g. BBS name and  password), most  have some.   If  the value entered
  188.      into  a  field  is  'illegal'  (such  as a letter in the 'Times Called'
  189.      field), one of two things will happen.  If available,  a menu  of valid
  190.      options will  be popped  up, as  explained earlier.  Pick one of these.
  191.      Otherwise, TFE will display a message informing you that the  value you
  192.      have entered is not valid.  You must re-enter an acceptable value.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.      TelixFonEd (TFE) v1.0                                          page  5
  199.  
  200.  
  201.                                   Special Keys
  202.  
  203.      In addition  to the  aforementioned editing  and movement keys, several
  204.      'special' keys  are  defined.    These  are  called  'Alt-letter' keys,
  205.      because  they  are  used  by  holding  down the 'Alt' key and hitting a
  206.      letter.
  207.      Here is a quick list, followed by a detailed explanation  of each key's
  208.      function.
  209.  
  210.           Alt-C:    Copy a range of entries
  211.           Alt-D:    Delete a range of entries
  212.           Alt-E:    Export a specified range of entries to a FON file
  213.           Alt-I:    Insert a specified number of entries
  214.           Alt-M:    Move a range of entries to another part of the directory
  215.           Alt-O:    impOrt  (merge)   another  FON  file  into  the  current
  216.                     directory
  217.           Alt-P:    Print a range (or all) of the current directory
  218.           Alt-R:    Read a new FON file
  219.           Alt-S:    Sort the current directory by name
  220.           Alt-W:    Write the current FON file with a specified name
  221.           Alt-X:    eXit TFE
  222.  
  223.  
  224.      Several of the commands will ask  you to  indicate a  range or  a line.
  225.      When indicating a range, you will use the Up, Down, Home, End, PgUp and
  226.      PgDn keys to highlight  a range  of entries  starting with  the current
  227.      line.   The range can extend above or below the current line.  Indicat-
  228.      ing a line is similar -- just move  the highlight  bar to  the position
  229.      you wish to indicate and press <enter>.  Pressing ESC when indicating a
  230.      range or line will cancel the current command.
  231.  
  232.      You will also occasionally be prompted to enter  some information, such
  233.      as a  number or  filename.   All editing keys are available to you, and
  234.      again, pressing ESC will cancel the command.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.      TelixFonEd (TFE) v1.0                                          page  6
  242.  
  243.  
  244.      Alt-C (Copy):
  245.           The Copy command lets you duplicate a range of entries  and insert
  246.           the new  range anywhere in the FON directory.  This is useful when
  247.           you want to add new entries which are similar to existing entries.
  248.           Indicate the  range you  wish to  copy, then the position to which
  249.           you wish to copy it.  The duplicate lines will be inserted  at the
  250.           specified position.
  251.  
  252.      Alt-D (Delete):
  253.           The Delete  command allows you to remove a range of lines from the
  254.           FON directory.   Simply  highlight the  range you  wish to delete,
  255.           then press <enter>.
  256.  
  257.      Alt-E (Export):
  258.           The Export  command writes a specified range of entries to a file.
  259.           Highlight the range you wish to write to a new FON file,  then hit
  260.           <enter>.   You will  be prompted to enter a filename; if you leave
  261.           out the extension, .FON will be added for you.  The new  file will
  262.           be created, and the range of entries will be left untouched in the
  263.           current directory.
  264.  
  265.      Alt-I (Insert):
  266.           Use the Insert command to add  a  number  of  new  entries  at the
  267.           current position  in the  FON directory.  You will be prompted for
  268.           the number of entries  to insert.   All  entries have  the default
  269.           values specified in your TELIX.CNF file.
  270.  
  271.      Alt-M (Move):
  272.           The Move  command lets you move a range of entries to another part
  273.           of the directory.  It is similar to the Copy  command, except that
  274.           the  original  lines  are  deleted.   Highlight the desired range,
  275.           press <enter>,  then indicate  the position  to which  you wish to
  276.           move the range.
  277.  
  278.      Alt-O (impOrt):
  279.           The impOrt  command reads in the entries from a specified FON file
  280.           and inserts them at the current position in  the edited directory.
  281.           Just enter  a FON filename when prompted, and the entries from the
  282.           specified file will be inserted.
  283.  
  284.      Alt-P (Print):
  285.           The Print command prints  the  Name,  Number,  Baud,  Parity, Stop
  286.           Bits, and  Script fields  of a  specified range  to a  file or the
  287.           printer in a formatted, paginated list.   Highlight  the range you
  288.           want to print, or hit ESC to print the entire directory (note that
  289.           this is the one time that  ESC  won't  cancel  a  command;   don't
  290.           worry, you'll  get another  chance when  you're entering the file-
  291.           name).  At this point, enter the filename (or just  hit <enter> to
  292.           write to LPT1).
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.      TelixFonEd (TFE) v1.0                                          page  7
  300.  
  301.  
  302.      Alt-R (Read):
  303.           The Read  command replaces the currently edited FON directory with
  304.           one read from a specified file, just as if you had exited  TFE and
  305.           run  it  again  with  a  different  FON file name.  Just enter the
  306.           filename when  prompted.   If the  directory has  been changed (by
  307.           Inserting,  Deleting,  Copying,  Moving,  editing, etc.) since the
  308.           last Write or Read command, you will be  asked to  confirm whether
  309.           you want clear the current entries without saving them to disk.
  310.  
  311.      Alt-S (Sort):
  312.           The Sort  command sorts the entire FON directory by name.  Case is
  313.           not significant when sorting.    Leading  spaces  are  ignored, so
  314.           "That BBS"  and "   That BBS" are treated as the same name.  Also,
  315.           if the first word in a name is "the," it will be ignored, so "BBS"
  316.           and "The BBS" will also compare the same.  Users of TelixSort will
  317.           be familiar with the sort behavior.
  318.  
  319.      Alt-W (Write):
  320.           The Write command writes the current directory as a FON file.  The
  321.           current directory is not disturbed.
  322.  
  323.      Alt-X (eXit):
  324.           The eXit  command quits TFE and exits to DOS.  If the current file
  325.           has changed since the last Read  or  Write  command,  you  will be
  326.           asked to confirm your intention.  Otherwise, TFE will exit without
  327.           incident.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      TelixFonEd (TFE) v1.0                                          page  8
  335.  
  336.  
  337.                                   Registration
  338.  
  339.  
  340.      TelixFonEd is distributed as shareware.    You  get  to  try  the full,
  341.      working program  out to  see if it suits your needs.  If you DO find it
  342.      useful, you must register  the program.   Just  to prod  your good will
  343.      along,  registration  has  a  few  perks:   you will receive the latest
  344.      version of TelixFonEd on disk (a  version without  the shareware  ad at
  345.      exit), and  for an  extra ten dollars, you will receive complete source
  346.      code (mainly in Microsoft C, with a little  bit of  assembly language).
  347.      Without registrations,  there will  soon cease to BE future versions of
  348.      TFE; sorry, but I've got to make a living, and  I'm much  more inclined
  349.      to work on projects that will help me pay my bills or finish getting my
  350.      degree.    Note that TFE may NOT be  used in  a business  or commercial
  351.      environment without registration.
  352.  
  353.      Basic  registration  is  currently  ten  dollars,  including  shipping,
  354.      handling, and cost of  a floppy  disk (with  the latest  version).  For
  355.      twenty  dollars,  you  will  also  receive  complete source code to the
  356.      latest version of TFE.  If you do not need the latest  version on disk,
  357.      simply send  five dollars.   If you send a SASE disk and mailer, regis-
  358.      tration is five dollars or fifteen dollars with source code.  Currently
  359.      registered users can upgrade to the latest version for five dollars, or
  360.      for free if a SASE disk and mailer are enclosed.
  361.  
  362.      If the source code option is desired, you  MUST sign  the form agreeing
  363.      not to  distribute the  source code.  Sorry, but I really have to limit
  364.      the source to licensed users.  If no signature is  supplied, you'll get
  365.      regular registration and a ten dollar rebate.
  366.  
  367.      Thank you very much for registering.
  368.  
  369.      The registration form follows.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.      TelixFonEd (TFE) v1.0                                          page  9
  377.  
  378.  
  379.                           TelixFonEd Registration Form
  380.  
  381.  
  382.      I would like to register TFE in the following manner (check one):
  383.  
  384.      __   Regular registration (latest version on disk)     $10.00
  385.  
  386.      __   Source code option and latest version             $20.00
  387.  
  388.      __   Registration with no disk                         $ 5.00
  389.  
  390.      __   Regular registration with SASE disk and mailer    $ 5.00
  391.  
  392.      __   Source code option with SASE disk and mailer      $15.00
  393.  
  394.      __   Registered user upgrade - $5.00 or SASE disk and mailer
  395.  
  396.  
  397.      I am enclosing a check or money order for the appropriate amount.
  398.  
  399.  
  400.      Name:               ___________________________________________________
  401.  
  402.      Street Address:     ___________________________________________________
  403.  
  404.      City, ST:           ___________________________________________________
  405.  
  406.      Zip:                                                        ___________
  407.  
  408.      Home Phone number:  (_____)-______________
  409.  
  410.  
  411.      If you  have selected  the source  code option,  please sign  here.  By
  412.      signing here you agree to not distribute the  source code  to TFE.   If
  413.      you do not sign,  $10.00 of your fee will be refunded.
  414.  
  415.  
  416.      I agree to the above terms:   ________________________________________
  417.  
  418.  
  419.      Please send  this completed  form, along with your check or money order
  420.      and disk and mailer if applicable, to:
  421.  
  422.  
  423.                                Paul Roub
  424.                                690 Anderson Court
  425.                                Satellite Beach, FL
  426.                                              32937
  427.  
  428.